home *** CD-ROM | disk | FTP | other *** search
/ SGI Developer Toolbox 6.1 / SGI Developer Toolbox 6.1 - Disc 1.iso / toolbox / documents / RFC / rfc / rfc1907.Z / rfc1907
Encoding:
Text File  |  1996-11-11  |  34.1 KB  |  1,124 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7. Network Working Group                               SNMPv2 Working Group
  8. Request for Comments: 1907                                       J. Case
  9. Obsoletes: 1450                                      SNMP Research, Inc.
  10. Category: Standards Track                                  K. McCloghrie
  11.                                                      Cisco Systems, Inc.
  12.                                                                  M. Rose
  13.                                             Dover Beach Consulting, Inc.
  14.                                                            S. Waldbusser
  15.                                           International Network Services
  16.                                                             January 1996
  17.  
  18.  
  19.                       Management Information Base
  20.                           for Version 2 of the
  21.               Simple Network Management Protocol (SNMPv2)
  22.  
  23. Status of this Memo
  24.  
  25.    This document specifies an Internet standards track protocol for the
  26.    Internet community, and requests discussion and suggestions for
  27.    improvements.  Please refer to the current edition of the "Internet
  28.    Official Protocol Standards" (STD 1) for the standardization state
  29.    and status of this protocol.  Distribution of this memo is unlimited.
  30.  
  31. Table of Contents
  32.  
  33.    1. Introduction ................................................    2
  34.    1.1 A Note on Terminology ......................................    2
  35.    2. Definitions .................................................    2
  36.    2.1 The System Group ...........................................    3
  37.    2.2 The SNMP Group .............................................    7
  38.    2.4 Information for Notifications ..............................    9
  39.    2.4.1 Well-known Traps .........................................   10
  40.    2.5 The Set Group ..............................................   11
  41.    2.6 Conformance Information ....................................   11
  42.    2.6.1 Compliance Statements ....................................   11
  43.    2.6.2 Units of Conformance .....................................   12
  44.    2.6.3 Obsolete Definitions .....................................   13
  45.    3. Security Considerations .....................................   18
  46.    4. Editor's Address ............................................   19
  47.    5. Acknowledgements ............................................   19
  48.    6. References ..................................................   20
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58. SNMPv2 Working Group        Standards Track                     [Page 1]
  59.  
  60. RFC 1907         Management Information Base for SNMPv2     January 1996
  61.  
  62.  
  63. 1.  Introduction
  64.  
  65.    A management system contains:  several (potentially many) nodes, each
  66.    with a processing entity, termed an agent, which has access to
  67.    management instrumentation; at least one management station; and, a
  68.    management protocol, used to convey management information between
  69.    the agents and management stations.  Operations of the protocol are
  70.    carried out under an administrative framework which defines
  71.    authentication, authorization, access control, and privacy policies.
  72.  
  73.    Management stations execute management applications which monitor and
  74.    control managed elements.  Managed elements are devices such as
  75.    hosts, routers, terminal servers, etc., which are monitored and
  76.    controlled via access to their management information.
  77.  
  78.    Management information is viewed as a collection of managed objects,
  79.    residing in a virtual information store, termed the Management
  80.    Information Base (MIB).  Collections of related objects are defined
  81.    in MIB modules.  These modules are written using a subset of OSI's
  82.    Abstract Syntax Notation One (ASN.1) [1], termed the Structure of
  83.    Management Information (SMI) [2].
  84.  
  85.    The management protocol, SNMPv2 [3], provides for the exchange of
  86.    messages which convey management information between the agents and
  87.    the management stations.  It is the purpose of this document to
  88.    define managed objects which describe the behavior of a SNMPv2
  89.    entity.
  90.  
  91. 1.1.  A Note on Terminology
  92.  
  93.    For the purpose of exposition, the original Internet-standard Network
  94.    Management Framework, as described in RFCs 1155 (STD 16), 1157 (STD
  95.    15), and 1212 (STD 16), is termed the SNMP version 1 framework
  96.    (SNMPv1).  The current framework is termed the SNMP version 2
  97.    framework (SNMPv2).
  98.  
  99. 2.  Definitions
  100.  
  101. SNMPv2-MIB DEFINITIONS ::= BEGIN
  102.  
  103. IMPORTS
  104.     MODULE-IDENTITY, OBJECT-TYPE, NOTIFICATION-TYPE,
  105.     TimeTicks, Counter32, snmpModules, mib-2
  106.         FROM SNMPv2-SMI
  107.     DisplayString, TestAndIncr, TimeStamp
  108.         FROM SNMPv2-TC
  109.     MODULE-COMPLIANCE, OBJECT-GROUP, NOTIFICATION-GROUP
  110.         FROM SNMPv2-CONF;
  111.  
  112.  
  113.  
  114. SNMPv2 Working Group        Standards Track                     [Page 2]
  115.  
  116. RFC 1907         Management Information Base for SNMPv2     January 1996
  117.  
  118.  
  119. snmpMIB MODULE-IDENTITY
  120.     LAST-UPDATED "9511090000Z"
  121.     ORGANIZATION "IETF SNMPv2 Working Group"
  122.     CONTACT-INFO
  123.             "        Marshall T. Rose
  124.  
  125.              Postal: Dover Beach Consulting, Inc.
  126.                      420 Whisman Court
  127.                      Mountain View, CA  94043-2186
  128.                      US
  129.  
  130.                 Tel: +1 415 968 1052
  131.  
  132.              E-mail: mrose@dbc.mtview.ca.us"
  133.     DESCRIPTION
  134.             "The MIB module for SNMPv2 entities."
  135.     REVISION      "9304010000Z"
  136.     DESCRIPTION
  137.             "The initial revision of this MIB module was published as
  138.             RFC 1450."
  139.     ::= { snmpModules 1 }
  140.  
  141.  
  142. snmpMIBObjects OBJECT IDENTIFIER ::= { snmpMIB 1 }
  143.  
  144. --  ::= { snmpMIBObjects 1 }        this OID is obsolete
  145. --  ::= { snmpMIBObjects 2 }        this OID is obsolete
  146. --  ::= { snmpMIBObjects 3 }        this OID is obsolete
  147.  
  148.  
  149. -- the System group
  150. --
  151. -- a collection of objects common to all managed systems.
  152.  
  153. system   OBJECT IDENTIFIER ::= { mib-2 1 }
  154.  
  155. sysDescr OBJECT-TYPE
  156.     SYNTAX      DisplayString (SIZE (0..255))
  157.     MAX-ACCESS  read-only
  158.     STATUS      current
  159.     DESCRIPTION
  160.             "A textual description of the entity.  This value should
  161.             include the full name and version identification of the
  162.             system's hardware type, software operating-system, and
  163.             networking software."
  164.     ::= { system 1 }
  165.  
  166. sysObjectID OBJECT-TYPE
  167.  
  168.  
  169.  
  170. SNMPv2 Working Group        Standards Track                     [Page 3]
  171.  
  172. RFC 1907         Management Information Base for SNMPv2     January 1996
  173.  
  174.  
  175.     SYNTAX      OBJECT IDENTIFIER
  176.     MAX-ACCESS  read-only
  177.     STATUS      current
  178.     DESCRIPTION
  179.             "The vendor's authoritative identification of the network
  180.             management subsystem contained in the entity.  This value is
  181.             allocated within the SMI enterprises subtree (1.3.6.1.4.1)
  182.             and provides an easy and unambiguous means for determining
  183.             `what kind of box' is being managed.  For example, if vendor
  184.             `Flintstones, Inc.' was assigned the subtree
  185.             1.3.6.1.4.1.4242, it could assign the identifier
  186.             1.3.6.1.4.1.4242.1.1 to its `Fred Router'."
  187.     ::= { system 2 }
  188.  
  189. sysUpTime OBJECT-TYPE
  190.     SYNTAX      TimeTicks
  191.     MAX-ACCESS  read-only
  192.     STATUS      current
  193.     DESCRIPTION
  194.             "The time (in hundredths of a second) since the network
  195.             management portion of the system was last re-initialized."
  196.     ::= { system 3 }
  197.  
  198. sysContact OBJECT-TYPE
  199.     SYNTAX      DisplayString (SIZE (0..255))
  200.     MAX-ACCESS  read-write
  201.     STATUS      current
  202.     DESCRIPTION
  203.             "The textual identification of the contact person for this
  204.             managed node, together with information on how to contact
  205.             this person.  If no contact information is known, the value
  206.             is the zero-length string."
  207.     ::= { system 4 }
  208.  
  209. sysName OBJECT-TYPE
  210.     SYNTAX      DisplayString (SIZE (0..255))
  211.     MAX-ACCESS  read-write
  212.     STATUS      current
  213.     DESCRIPTION
  214.             "An administratively-assigned name for this managed node.
  215.             By convention, this is the node's fully-qualified domain
  216.             name.  If the name is unknown, the value is the zero-length
  217.             string."
  218.     ::= { system 5 }
  219.  
  220. sysLocation OBJECT-TYPE
  221.     SYNTAX      DisplayString (SIZE (0..255))
  222.     MAX-ACCESS  read-write
  223.  
  224.  
  225.  
  226. SNMPv2 Working Group        Standards Track                     [Page 4]
  227.  
  228. RFC 1907         Management Information Base for SNMPv2     January 1996
  229.  
  230.  
  231.     STATUS      current
  232.     DESCRIPTION
  233.             "The physical location of this node (e.g., `telephone
  234.             closet, 3rd floor').  If the location is unknown, the value
  235.             is the zero-length string."
  236.     ::= { system 6 }
  237.  
  238. sysServices OBJECT-TYPE
  239.     SYNTAX      INTEGER (0..127)
  240.     MAX-ACCESS  read-only
  241.     STATUS      current
  242.     DESCRIPTION
  243.             "A value which indicates the set of services that this
  244.             entity may potentially offers.  The value is a sum.  This
  245.             sum initially takes the value zero, Then, for each layer, L,
  246.             in the range 1 through 7, that this node performs
  247.             transactions for, 2 raised to (L - 1) is added to the sum.
  248.             For example, a node which performs only routing functions
  249.             would have a value of 4 (2^(3-1)).  In contrast, a node
  250.             which is a host offering application services would have a
  251.             value of 72 (2^(4-1) + 2^(7-1)).  Note that in the context
  252.             of the Internet suite of protocols, values should be
  253.             calculated accordingly:
  254.  
  255.                  layer      functionality
  256.                    1        physical (e.g., repeaters)
  257.                    2        datalink/subnetwork (e.g., bridges)
  258.                    3        internet (e.g., supports the IP)
  259.                    4        end-to-end  (e.g., supports the TCP)
  260.                    7        applications (e.g., supports the SMTP)
  261.  
  262.             For systems including OSI protocols, layers 5 and 6 may also
  263.             be counted."
  264.     ::= { system 7 }
  265.  
  266.  
  267. -- object resource information
  268. --
  269. -- a collection of objects which describe the SNMPv2 entity's
  270. -- (statically and dynamically configurable) support of
  271. -- various MIB modules.
  272.  
  273. sysORLastChange OBJECT-TYPE
  274.     SYNTAX     TimeStamp
  275.     MAX-ACCESS read-only
  276.     STATUS     current
  277.     DESCRIPTION
  278.             "The value of sysUpTime at the time of the most recent
  279.  
  280.  
  281.  
  282. SNMPv2 Working Group        Standards Track                     [Page 5]
  283.  
  284. RFC 1907         Management Information Base for SNMPv2     January 1996
  285.  
  286.  
  287.             change in state or value of any instance of sysORID."
  288.     ::= { system 8 }
  289.  
  290. sysORTable OBJECT-TYPE
  291.     SYNTAX     SEQUENCE OF SysOREntry
  292.     MAX-ACCESS not-accessible
  293.     STATUS     current
  294.     DESCRIPTION
  295.             "The (conceptual) table listing the capabilities of the
  296.             local SNMPv2 entity acting in an agent role with respect to
  297.             various MIB modules.  SNMPv2 entities having dynamically-
  298.             configurable support of MIB modules will have a
  299.             dynamically-varying number of conceptual rows."
  300.     ::= { system 9 }
  301.  
  302. sysOREntry OBJECT-TYPE
  303.     SYNTAX     SysOREntry
  304.     MAX-ACCESS not-accessible
  305.     STATUS     current
  306.     DESCRIPTION
  307.             "An entry (conceptual row) in the sysORTable."
  308.     INDEX      { sysORIndex }
  309.     ::= { sysORTable 1 }
  310.  
  311. SysOREntry ::= SEQUENCE {
  312.     sysORIndex     INTEGER,
  313.     sysORID        OBJECT IDENTIFIER,
  314.     sysORDescr     DisplayString,
  315.     sysORUpTime    TimeStamp
  316. }
  317.  
  318. sysORIndex OBJECT-TYPE
  319.     SYNTAX     INTEGER (1..2147483647)
  320.     MAX-ACCESS not-accessible
  321.     STATUS     current
  322.     DESCRIPTION
  323.             "The auxiliary variable used for identifying instances of
  324.             the columnar objects in the sysORTable."
  325.     ::= { sysOREntry 1 }
  326.  
  327. sysORID OBJECT-TYPE
  328.     SYNTAX     OBJECT IDENTIFIER
  329.     MAX-ACCESS read-only
  330.     STATUS     current
  331.     DESCRIPTION
  332.             "An authoritative identification of a capabilities statement
  333.             with respect to various MIB modules supported by the local
  334.             SNMPv2 entity acting in an agent role."
  335.  
  336.  
  337.  
  338. SNMPv2 Working Group        Standards Track                     [Page 6]
  339.  
  340. RFC 1907         Management Information Base for SNMPv2     January 1996
  341.  
  342.  
  343.     ::= { sysOREntry 2 }
  344.  
  345. sysORDescr OBJECT-TYPE
  346.     SYNTAX     DisplayString
  347.     MAX-ACCESS read-only
  348.     STATUS     current
  349.     DESCRIPTION
  350.             "A textual description of the capabilities identified by the
  351.             corresponding instance of sysORID."
  352.     ::= { sysOREntry 3 }
  353.  
  354. sysORUpTime OBJECT-TYPE
  355.     SYNTAX     TimeStamp
  356.     MAX-ACCESS read-only
  357.     STATUS     current
  358.     DESCRIPTION
  359.             "The value of sysUpTime at the time this conceptual row was
  360.             last instanciated."
  361.     ::= { sysOREntry 4 }
  362.  
  363.  
  364. -- the SNMP group
  365. --
  366. -- a collection of objects providing basic instrumentation and
  367. -- control of an SNMP entity.
  368.  
  369. snmp     OBJECT IDENTIFIER ::= { mib-2 11 }
  370.  
  371. snmpInPkts OBJECT-TYPE
  372.     SYNTAX     Counter32
  373.     MAX-ACCESS read-only
  374.     STATUS     current
  375.     DESCRIPTION
  376.             "The total number of messages delivered to the SNMP entity
  377.             from the transport service."
  378.     ::= { snmp 1 }
  379.  
  380. snmpInBadVersions OBJECT-TYPE
  381.     SYNTAX     Counter32
  382.     MAX-ACCESS read-only
  383.     STATUS     current
  384.     DESCRIPTION
  385.             "The total number of SNMP messages which were delivered to
  386.             the SNMP entity and were for an unsupported SNMP version."
  387.     ::= { snmp 3 }
  388.  
  389. snmpInBadCommunityNames OBJECT-TYPE
  390.     SYNTAX     Counter32
  391.  
  392.  
  393.  
  394. SNMPv2 Working Group        Standards Track                     [Page 7]
  395.  
  396. RFC 1907         Management Information Base for SNMPv2     January 1996
  397.  
  398.  
  399.     MAX-ACCESS read-only
  400.     STATUS     current
  401.     DESCRIPTION
  402.             "The total number of SNMP messages delivered to the SNMP
  403.             entity which used a SNMP community name not known to said
  404.             entity."
  405.     ::= { snmp 4 }
  406.  
  407. snmpInBadCommunityUses OBJECT-TYPE
  408.     SYNTAX     Counter32
  409.     MAX-ACCESS read-only
  410.     STATUS     current
  411.     DESCRIPTION
  412.             "The total number of SNMP messages delivered to the SNMP
  413.             entity which represented an SNMP operation which was not
  414.             allowed by the SNMP community named in the message."
  415.     ::= { snmp 5 }
  416.  
  417. snmpInASNParseErrs OBJECT-TYPE
  418.     SYNTAX     Counter32
  419.     MAX-ACCESS read-only
  420.     STATUS     current
  421.     DESCRIPTION
  422.             "The total number of ASN.1 or BER errors encountered by the
  423.             SNMP entity when decoding received SNMP messages."
  424.     ::= { snmp 6 }
  425.  
  426. snmpEnableAuthenTraps OBJECT-TYPE
  427.     SYNTAX      INTEGER { enabled(1), disabled(2) }
  428.     MAX-ACCESS  read-write
  429.     STATUS      current
  430.     DESCRIPTION
  431.             "Indicates whether the SNMP entity is permitted to generate
  432.             authenticationFailure traps.  The value of this object
  433.             overrides any configuration information; as such, it
  434.             provides a means whereby all authenticationFailure traps may
  435.             be disabled.
  436.  
  437.             Note that it is strongly recommended that this object be
  438.             stored in non-volatile memory so that it remains constant
  439.             across re-initializations of the network management system."
  440.     ::= { snmp 30 }
  441.  
  442. snmpSilentDrops OBJECT-TYPE
  443.     SYNTAX     Counter32
  444.     MAX-ACCESS read-only
  445.     STATUS     current
  446.     DESCRIPTION
  447.  
  448.  
  449.  
  450. SNMPv2 Working Group        Standards Track                     [Page 8]
  451.  
  452. RFC 1907         Management Information Base for SNMPv2     January 1996
  453.  
  454.  
  455.             "The total number of GetRequest-PDUs, GetNextRequest-PDUs,
  456.             GetBulkRequest-PDUs, SetRequest-PDUs, and InformRequest-PDUs
  457.             delivered to the SNMP entity which were silently dropped
  458.             because the size of a reply containing an alternate
  459.             Response-PDU with an empty variable-bindings field was
  460.             greater than either a local constraint or the maximum
  461.             message size associated with the originator of the request."
  462.     ::= { snmp 31 }
  463.  
  464. snmpProxyDrops OBJECT-TYPE
  465.     SYNTAX     Counter32
  466.     MAX-ACCESS read-only
  467.     STATUS     current
  468.     DESCRIPTION
  469.             "The total number of GetRequest-PDUs, GetNextRequest-PDUs,
  470.             GetBulkRequest-PDUs, SetRequest-PDUs, and InformRequest-PDUs
  471.             delivered to the SNMP entity which were silently dropped
  472.             because the transmission of the (possibly translated)
  473.             message to a proxy target failed in a manner (other than a
  474.             time-out) such that no Response-PDU could be returned."
  475.     ::= { snmp 32 }
  476.  
  477.  
  478. -- information for notifications
  479. --
  480. -- a collection of objects which allow the SNMPv2 entity, when
  481. -- acting in an agent role, to be configured to generate
  482. -- SNMPv2-Trap-PDUs.
  483.  
  484. snmpTrap       OBJECT IDENTIFIER ::= { snmpMIBObjects 4 }
  485.  
  486.  
  487. snmpTrapOID OBJECT-TYPE
  488.     SYNTAX     OBJECT IDENTIFIER
  489.     MAX-ACCESS accessible-for-notify
  490.     STATUS     current
  491.     DESCRIPTION
  492.             "The authoritative identification of the notification
  493.             currently being sent.  This variable occurs as the second
  494.             varbind in every SNMPv2-Trap-PDU and InformRequest-PDU."
  495.     ::= { snmpTrap 1 }
  496.  
  497. --  ::= { snmpTrap 2 }   this OID is obsolete
  498.  
  499. snmpTrapEnterprise OBJECT-TYPE
  500.     SYNTAX     OBJECT IDENTIFIER
  501.     MAX-ACCESS accessible-for-notify
  502.     STATUS     current
  503.  
  504.  
  505.  
  506. SNMPv2 Working Group        Standards Track                     [Page 9]
  507.  
  508. RFC 1907         Management Information Base for SNMPv2     January 1996
  509.  
  510.  
  511.     DESCRIPTION
  512.             "The authoritative identification of the enterprise
  513.             associated with the trap currently being sent.  When a
  514.             SNMPv2 proxy agent is mapping an RFC1157 Trap-PDU into a
  515.             SNMPv2-Trap-PDU, this variable occurs as the last varbind."
  516.     ::= { snmpTrap 3 }
  517.  
  518. --  ::= { snmpTrap 4 }   this OID is obsolete
  519.  
  520.  
  521. -- well-known traps
  522.  
  523. snmpTraps      OBJECT IDENTIFIER ::= { snmpMIBObjects 5 }
  524.  
  525. coldStart NOTIFICATION-TYPE
  526.     STATUS  current
  527.     DESCRIPTION
  528.             "A coldStart trap signifies that the SNMPv2 entity, acting
  529.             in an agent role, is reinitializing itself and that its
  530.             configuration may have been altered."
  531.     ::= { snmpTraps 1 }
  532.  
  533. warmStart NOTIFICATION-TYPE
  534.     STATUS  current
  535.     DESCRIPTION
  536.             "A warmStart trap signifies that the SNMPv2 entity, acting
  537.             in an agent role, is reinitializing itself such that its
  538.             configuration is unaltered."
  539.     ::= { snmpTraps 2 }
  540.  
  541. -- Note the linkDown NOTIFICATION-TYPE ::= { snmpTraps 3 }
  542. -- and the linkUp NOTIFICATION-TYPE ::= { snmpTraps 4 }
  543. -- are defined in RFC 1573
  544.  
  545. authenticationFailure NOTIFICATION-TYPE
  546.     STATUS  current
  547.     DESCRIPTION
  548.             "An authenticationFailure trap signifies that the SNMPv2
  549.             entity, acting in an agent role, has received a protocol
  550.             message that is not properly authenticated.  While all
  551.             implementations of the SNMPv2 must be capable of generating
  552.             this trap, the snmpEnableAuthenTraps object indicates
  553.             whether this trap will be generated."
  554.     ::= { snmpTraps 5 }
  555.  
  556. -- Note the egpNeighborLoss NOTIFICATION-TYPE ::= { snmpTraps 6 }
  557. -- is defined in RFC 1213
  558.  
  559.  
  560.  
  561.  
  562. SNMPv2 Working Group        Standards Track                    [Page 10]
  563.  
  564. RFC 1907         Management Information Base for SNMPv2     January 1996
  565.  
  566.  
  567. -- the set group
  568. --
  569. -- a collection of objects which allow several cooperating
  570. -- SNMPv2 entities, all acting in a manager role, to
  571. -- coordinate their use of the SNMPv2 set operation.
  572.  
  573. snmpSet        OBJECT IDENTIFIER ::= { snmpMIBObjects 6 }
  574.  
  575.  
  576. snmpSetSerialNo OBJECT-TYPE
  577.     SYNTAX     TestAndIncr
  578.     MAX-ACCESS read-write
  579.     STATUS     current
  580.     DESCRIPTION
  581.             "An advisory lock used to allow several cooperating SNMPv2
  582.             entities, all acting in a manager role, to coordinate their
  583.             use of the SNMPv2 set operation.
  584.  
  585.             This object is used for coarse-grain coordination.  To
  586.             achieve fine-grain coordination, one or more similar objects
  587.             might be defined within each MIB group, as appropriate."
  588.     ::= { snmpSet 1 }
  589.  
  590.  
  591. -- conformance information
  592.  
  593. snmpMIBConformance
  594.                OBJECT IDENTIFIER ::= { snmpMIB 2 }
  595.  
  596. snmpMIBCompliances
  597.                OBJECT IDENTIFIER ::= { snmpMIBConformance 1 }
  598. snmpMIBGroups  OBJECT IDENTIFIER ::= { snmpMIBConformance 2 }
  599.  
  600.  
  601. -- compliance statements
  602.  
  603. --    ::= { snmpMIBCompliances 1 }      this OID is obsolete
  604.  
  605. snmpBasicCompliance MODULE-COMPLIANCE
  606.     STATUS  current
  607.     DESCRIPTION
  608.             "The compliance statement for SNMPv2 entities which
  609.             implement the SNMPv2 MIB."
  610.     MODULE  -- this module
  611.         MANDATORY-GROUPS { snmpGroup, snmpSetGroup, systemGroup,
  612.                            snmpBasicNotificationsGroup }
  613.  
  614.         GROUP   snmpCommunityGroup
  615.  
  616.  
  617.  
  618. SNMPv2 Working Group        Standards Track                    [Page 11]
  619.  
  620. RFC 1907         Management Information Base for SNMPv2     January 1996
  621.  
  622.  
  623.         DESCRIPTION
  624.             "This group is mandatory for SNMPv2 entities which
  625.             support community-based authentication."
  626.  
  627.     ::= { snmpMIBCompliances 2 }
  628.  
  629.  
  630. -- units of conformance
  631.  
  632. --  ::= { snmpMIBGroups 1 }           this OID is obsolete
  633. --  ::= { snmpMIBGroups 2 }           this OID is obsolete
  634. --  ::= { snmpMIBGroups 3 }           this OID is obsolete
  635. --  ::= { snmpMIBGroups 4 }           this OID is obsolete
  636.  
  637. snmpGroup OBJECT-GROUP
  638.     OBJECTS { snmpInPkts,
  639.               snmpInBadVersions,
  640.               snmpInASNParseErrs,
  641.               snmpSilentDrops,
  642.               snmpProxyDrops,
  643.               snmpEnableAuthenTraps }
  644.     STATUS  current
  645.     DESCRIPTION
  646.             "A collection of objects providing basic instrumentation and
  647.             control of an SNMPv2 entity."
  648.     ::= { snmpMIBGroups 8 }
  649.  
  650. snmpCommunityGroup OBJECT-GROUP
  651.     OBJECTS { snmpInBadCommunityNames,
  652.               snmpInBadCommunityUses }
  653.     STATUS  current
  654.     DESCRIPTION
  655.             "A collection of objects providing basic instrumentation of
  656.             a SNMPv2 entity which supports community-based
  657.             authentication."
  658.     ::= { snmpMIBGroups 9 }
  659.  
  660. snmpSetGroup OBJECT-GROUP
  661.     OBJECTS { snmpSetSerialNo }
  662.     STATUS  current
  663.     DESCRIPTION
  664.             "A collection of objects which allow several cooperating
  665.             SNMPv2 entities, all acting in a manager role, to coordinate
  666.             their use of the SNMPv2 set operation."
  667.     ::= { snmpMIBGroups 5 }
  668.  
  669. systemGroup OBJECT-GROUP
  670.     OBJECTS { sysDescr, sysObjectID, sysUpTime,
  671.  
  672.  
  673.  
  674. SNMPv2 Working Group        Standards Track                    [Page 12]
  675.  
  676. RFC 1907         Management Information Base for SNMPv2     January 1996
  677.  
  678.  
  679.               sysContact, sysName, sysLocation,
  680.               sysServices,
  681.               sysORLastChange, sysORID,
  682.               sysORUpTime, sysORDescr }
  683.     STATUS  current
  684.     DESCRIPTION
  685.             "The system group defines objects which are common to all
  686.             managed systems."
  687.     ::= { snmpMIBGroups 6 }
  688.  
  689. snmpBasicNotificationsGroup NOTIFICATION-GROUP
  690.     NOTIFICATIONS { coldStart, authenticationFailure }
  691.     STATUS        current
  692.     DESCRIPTION
  693.             "The two notifications which an SNMPv2 entity is required to
  694.             implement."
  695.     ::= { snmpMIBGroups 7 }
  696.  
  697.  
  698. -- definitions in RFC 1213 made obsolete by the inclusion of a
  699. -- subset of the snmp group in this MIB
  700.  
  701. snmpOutPkts OBJECT-TYPE
  702.     SYNTAX      Counter32
  703.     MAX-ACCESS  read-only
  704.     STATUS      obsolete
  705.     DESCRIPTION
  706.             "The total number of SNMP Messages which were
  707.             passed from the SNMP protocol entity to the
  708.             transport service."
  709.     ::= { snmp 2 }
  710.  
  711. -- { snmp 7 } is not used
  712.  
  713. snmpInTooBigs OBJECT-TYPE
  714.     SYNTAX      Counter32
  715.     MAX-ACCESS  read-only
  716.     STATUS      obsolete
  717.     DESCRIPTION
  718.             "The total number of SNMP PDUs which were
  719.             delivered to the SNMP protocol entity and for
  720.             which the value of the error-status field is
  721.             `tooBig'."
  722.     ::= { snmp 8 }
  723.  
  724. snmpInNoSuchNames OBJECT-TYPE
  725.     SYNTAX      Counter32
  726.     MAX-ACCESS  read-only
  727.  
  728.  
  729.  
  730. SNMPv2 Working Group        Standards Track                    [Page 13]
  731.  
  732. RFC 1907         Management Information Base for SNMPv2     January 1996
  733.  
  734.  
  735.     STATUS      obsolete
  736.     DESCRIPTION
  737.             "The total number of SNMP PDUs which were
  738.             delivered to the SNMP protocol entity and for
  739.             which the value of the error-status field is
  740.             `noSuchName'."
  741.     ::= { snmp 9 }
  742.  
  743. snmpInBadValues OBJECT-TYPE
  744.     SYNTAX      Counter32
  745.     MAX-ACCESS  read-only
  746.     STATUS      obsolete
  747.     DESCRIPTION
  748.             "The total number of SNMP PDUs which were
  749.             delivered to the SNMP protocol entity and for
  750.             which the value of the error-status field is
  751.             `badValue'."
  752.     ::= { snmp 10 }
  753.  
  754. snmpInReadOnlys OBJECT-TYPE
  755.     SYNTAX      Counter32
  756.     MAX-ACCESS  read-only
  757.     STATUS      obsolete
  758.     DESCRIPTION
  759.             "The total number valid SNMP PDUs which were
  760.             delivered to the SNMP protocol entity and for
  761.             which the value of the error-status field is
  762.             `readOnly'.  It should be noted that it is a
  763.             protocol error to generate an SNMP PDU which
  764.             contains the value `readOnly' in the error-status
  765.             field, as such this object is provided as a means
  766.             of detecting incorrect implementations of the
  767.             SNMP."
  768.     ::= { snmp 11 }
  769.  
  770. snmpInGenErrs OBJECT-TYPE
  771.     SYNTAX      Counter32
  772.     MAX-ACCESS  read-only
  773.     STATUS      obsolete
  774.     DESCRIPTION
  775.             "The total number of SNMP PDUs which were
  776.             delivered to the SNMP protocol entity and for
  777.             which the value of the error-status field is
  778.             `genErr'."
  779.     ::= { snmp 12 }
  780.  
  781. snmpInTotalReqVars OBJECT-TYPE
  782.     SYNTAX      Counter32
  783.  
  784.  
  785.  
  786. SNMPv2 Working Group        Standards Track                    [Page 14]
  787.  
  788. RFC 1907         Management Information Base for SNMPv2     January 1996
  789.  
  790.  
  791.     MAX-ACCESS  read-only
  792.     STATUS      obsolete
  793.     DESCRIPTION
  794.             "The total number of MIB objects which have been
  795.             retrieved successfully by the SNMP protocol entity
  796.             as the result of receiving valid SNMP Get-Request
  797.             and Get-Next PDUs."
  798.     ::= { snmp 13 }
  799.  
  800. snmpInTotalSetVars OBJECT-TYPE
  801.     SYNTAX      Counter32
  802.     MAX-ACCESS  read-only
  803.     STATUS      obsolete
  804.     DESCRIPTION
  805.             "The total number of MIB objects which have been
  806.             altered successfully by the SNMP protocol entity
  807.             as the result of receiving valid SNMP Set-Request
  808.             PDUs."
  809.     ::= { snmp 14 }
  810.  
  811. snmpInGetRequests OBJECT-TYPE
  812.     SYNTAX      Counter32
  813.     MAX-ACCESS  read-only
  814.     STATUS      obsolete
  815.     DESCRIPTION
  816.             "The total number of SNMP Get-Request PDUs which
  817.             have been accepted and processed by the SNMP
  818.             protocol entity."
  819.     ::= { snmp 15 }
  820.  
  821. snmpInGetNexts OBJECT-TYPE
  822.     SYNTAX      Counter32
  823.     MAX-ACCESS  read-only
  824.     STATUS      obsolete
  825.     DESCRIPTION
  826.             "The total number of SNMP Get-Next PDUs which have
  827.             been accepted and processed by the SNMP protocol
  828.             entity."
  829.     ::= { snmp 16 }
  830.  
  831. snmpInSetRequests OBJECT-TYPE
  832.     SYNTAX      Counter32
  833.     MAX-ACCESS  read-only
  834.     STATUS      obsolete
  835.     DESCRIPTION
  836.             "The total number of SNMP Set-Request PDUs which
  837.             have been accepted and processed by the SNMP
  838.             protocol entity."
  839.  
  840.  
  841.  
  842. SNMPv2 Working Group        Standards Track                    [Page 15]
  843.  
  844. RFC 1907         Management Information Base for SNMPv2     January 1996
  845.  
  846.  
  847.     ::= { snmp 17 }
  848.  
  849. snmpInGetResponses OBJECT-TYPE
  850.     SYNTAX      Counter32
  851.     MAX-ACCESS  read-only
  852.     STATUS      obsolete
  853.     DESCRIPTION
  854.             "The total number of SNMP Get-Response PDUs which
  855.             have been accepted and processed by the SNMP
  856.             protocol entity."
  857.     ::= { snmp 18 }
  858.  
  859. snmpInTraps OBJECT-TYPE
  860.     SYNTAX      Counter32
  861.     MAX-ACCESS  read-only
  862.     STATUS      obsolete
  863.     DESCRIPTION
  864.             "The total number of SNMP Trap PDUs which have
  865.             been accepted and processed by the SNMP protocol
  866.             entity."
  867.     ::= { snmp 19 }
  868.  
  869. snmpOutTooBigs OBJECT-TYPE
  870.     SYNTAX      Counter32
  871.     MAX-ACCESS  read-only
  872.     STATUS      obsolete
  873.     DESCRIPTION
  874.             "The total number of SNMP PDUs which were
  875.             generated by the SNMP protocol entity and for
  876.             which the value of the error-status field is
  877.             `tooBig.'"
  878.     ::= { snmp 20 }
  879.  
  880. snmpOutNoSuchNames OBJECT-TYPE
  881.     SYNTAX      Counter32
  882.     MAX-ACCESS  read-only
  883.     STATUS      obsolete
  884.     DESCRIPTION
  885.             "The total number of SNMP PDUs which were
  886.             generated by the SNMP protocol entity and for
  887.             which the value of the error-status is
  888.             `noSuchName'."
  889.     ::= { snmp 21 }
  890.  
  891. snmpOutBadValues OBJECT-TYPE
  892.     SYNTAX      Counter32
  893.     MAX-ACCESS  read-only
  894.     STATUS      obsolete
  895.  
  896.  
  897.  
  898. SNMPv2 Working Group        Standards Track                    [Page 16]
  899.  
  900. RFC 1907         Management Information Base for SNMPv2     January 1996
  901.  
  902.  
  903.     DESCRIPTION
  904.             "The total number of SNMP PDUs which were
  905.             generated by the SNMP protocol entity and for
  906.             which the value of the error-status field is
  907.             `badValue'."
  908.     ::= { snmp 22 }
  909.  
  910.  
  911. -- { snmp 23 } is not used
  912.  
  913. snmpOutGenErrs OBJECT-TYPE
  914.     SYNTAX      Counter32
  915.     MAX-ACCESS  read-only
  916.     STATUS      obsolete
  917.     DESCRIPTION
  918.             "The total number of SNMP PDUs which were
  919.             generated by the SNMP protocol entity and for
  920.             which the value of the error-status field is
  921.             `genErr'."
  922.     ::= { snmp 24 }
  923.  
  924. snmpOutGetRequests OBJECT-TYPE
  925.     SYNTAX      Counter32
  926.     MAX-ACCESS  read-only
  927.     STATUS      obsolete
  928.     DESCRIPTION
  929.             "The total number of SNMP Get-Request PDUs which
  930.             have been generated by the SNMP protocol entity."
  931.     ::= { snmp 25 }
  932.  
  933. snmpOutGetNexts OBJECT-TYPE
  934.     SYNTAX      Counter32
  935.     MAX-ACCESS  read-only
  936.     STATUS      obsolete
  937.     DESCRIPTION
  938.             "The total number of SNMP Get-Next PDUs which have
  939.             been generated by the SNMP protocol entity."
  940.     ::= { snmp 26 }
  941.  
  942. snmpOutSetRequests OBJECT-TYPE
  943.     SYNTAX      Counter32
  944.     MAX-ACCESS  read-only
  945.     STATUS      obsolete
  946.     DESCRIPTION
  947.             "The total number of SNMP Set-Request PDUs which
  948.             have been generated by the SNMP protocol entity."
  949.     ::= { snmp 27 }
  950.  
  951.  
  952.  
  953.  
  954. SNMPv2 Working Group        Standards Track                    [Page 17]
  955.  
  956. RFC 1907         Management Information Base for SNMPv2     January 1996
  957.  
  958.  
  959. snmpOutGetResponses OBJECT-TYPE
  960.     SYNTAX      Counter32
  961.     MAX-ACCESS  read-only
  962.     STATUS      obsolete
  963.     DESCRIPTION
  964.             "The total number of SNMP Get-Response PDUs which
  965.             have been generated by the SNMP protocol entity."
  966.     ::= { snmp 28 }
  967.  
  968. snmpOutTraps OBJECT-TYPE
  969.     SYNTAX      Counter32
  970.     MAX-ACCESS  read-only
  971.     STATUS      obsolete
  972.     DESCRIPTION
  973.             "The total number of SNMP Trap PDUs which have
  974.             been generated by the SNMP protocol entity."
  975.     ::= { snmp 29 }
  976.  
  977. snmpObsoleteGroup OBJECT-GROUP
  978.     OBJECTS { snmpOutPkts, snmpInTooBigs, snmpInNoSuchNames,
  979.               snmpInBadValues, snmpInReadOnlys, snmpInGenErrs,
  980.               snmpInTotalReqVars, snmpInTotalSetVars,
  981.               snmpInGetRequests, snmpInGetNexts, snmpInSetRequests,
  982.               snmpInGetResponses, snmpInTraps, snmpOutTooBigs,
  983.               snmpOutNoSuchNames, snmpOutBadValues, snmpOutGenErrs,
  984.               snmpOutGetRequests, snmpOutGetNexts, snmpOutSetRequests,
  985.               snmpOutGetResponses, snmpOutTraps }
  986.     STATUS  obsolete
  987.     DESCRIPTION
  988.             "A collection of objects from RFC 1213 made obsolete by this
  989.             MIB."
  990.     ::= { snmpMIBGroups 10 }
  991.  
  992. END
  993.  
  994. 3.  Security Considerations
  995.  
  996.    Security issues are not discussed in this memo.
  997.  
  998.  
  999.  
  1000.  
  1001.  
  1002.  
  1003.  
  1004.  
  1005.  
  1006.  
  1007.  
  1008.  
  1009.  
  1010. SNMPv2 Working Group        Standards Track                    [Page 18]
  1011.  
  1012. RFC 1907         Management Information Base for SNMPv2     January 1996
  1013.  
  1014.  
  1015. 4.  Editor's Address
  1016.  
  1017.    Keith McCloghrie
  1018.    Cisco Systems, Inc.
  1019.    170 West Tasman Drive
  1020.    San Jose, CA  95134-1706
  1021.    US
  1022.  
  1023.    Phone: +1 408 526 5260
  1024.    EMail: kzm@cisco.com
  1025.  
  1026. 5.  Acknowledgements
  1027.  
  1028.    This document is the result of significant work by the four major
  1029.    contributors:
  1030.  
  1031.    Jeffrey D. Case (SNMP Research, case@snmp.com)
  1032.    Keith McCloghrie (Cisco Systems, kzm@cisco.com)
  1033.    Marshall T. Rose (Dover Beach Consulting, mrose@dbc.mtview.ca.us)
  1034.    Steven Waldbusser (International Network Services, stevew@uni.ins.com)
  1035.  
  1036.    In addition, the contributions of the SNMPv2 Working Group are
  1037.    acknowledged.  In particular, a special thanks is extended for the
  1038.    contributions of:
  1039.  
  1040.      Alexander I. Alten (Novell)
  1041.      Dave Arneson (Cabletron)
  1042.      Uri Blumenthal (IBM)
  1043.      Doug Book (Chipcom)
  1044.      Kim Curran (Bell-Northern Research)
  1045.      Jim Galvin (Trusted Information Systems)
  1046.      Maria Greene (Ascom Timeplex)
  1047.      Iain Hanson (Digital)
  1048.      Dave Harrington (Cabletron)
  1049.      Nguyen Hien (IBM)
  1050.      Jeff Johnson (Cisco Systems)
  1051.      Michael Kornegay (Object Quest)
  1052.      Deirdre Kostick (AT&T Bell Labs)
  1053.      David Levi (SNMP Research)
  1054.      Daniel Mahoney (Cabletron)
  1055.      Bob Natale (ACE*COMM)
  1056.      Brian O'Keefe (Hewlett Packard)
  1057.      Andrew Pearson (SNMP Research)
  1058.      Dave Perkins (Peer Networks)
  1059.      Randy Presuhn (Peer Networks)
  1060.      Aleksey Romanov (Quality Quorum)
  1061.      Shawn Routhier (Epilogue)
  1062.      Jon Saperia (BGS Systems)
  1063.  
  1064.  
  1065.  
  1066. SNMPv2 Working Group        Standards Track                    [Page 19]
  1067.  
  1068. RFC 1907         Management Information Base for SNMPv2     January 1996
  1069.  
  1070.  
  1071.      Bob Stewart (Cisco Systems, bstewart@cisco.com), chair
  1072.      Kaj Tesink (Bellcore)
  1073.      Glenn Waters (Bell-Northern Research)
  1074.      Bert Wijnen (IBM)
  1075.  
  1076. 6.  References
  1077.  
  1078. [1]  Information processing systems - Open Systems Interconnection -
  1079.      Specification of Abstract Syntax Notation One (ASN.1),
  1080.      International Organization for Standardization.  International
  1081.      Standard 8824, (December, 1987).
  1082.  
  1083. [2]  SNMPv2 Working Group, Case, J., McCloghrie, K., Rose, M., and
  1084.      S. Waldbusser, "Structure of Management Information for Version 2
  1085.      of the Simple Network Management Protocol (SNMPv2)", RFC 1902,
  1086.      January 1996.
  1087.  
  1088. [3]  SNMPv2 Working Group, Case, J., McCloghrie, K., Rose, M., and
  1089.      S. Waldbusser, "Protocol Operations for Version 2 of the Simple
  1090.      Network Management Protocol (SNMPv2)", RFC 1905, January 1996.
  1091.  
  1092. [4]  J.D. Case, C. Partridge, Case Diagrams: A First Step to Diagramed
  1093.      Management Information Bases.  Computer Communications Review,
  1094.      Volume 19, Number 1, (January, 1989).
  1095.  
  1096.  
  1097.  
  1098.  
  1099.  
  1100.  
  1101.  
  1102.  
  1103.  
  1104.  
  1105.  
  1106.  
  1107.  
  1108.  
  1109.  
  1110.  
  1111.  
  1112.  
  1113.  
  1114.  
  1115.  
  1116.  
  1117.  
  1118.  
  1119.  
  1120.  
  1121.  
  1122. SNMPv2 Working Group        Standards Track                    [Page 20]
  1123.  
  1124.